home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / vgacad25.zip / VGACAP.DOC < prev    next >
Text File  |  1991-02-21  |  17KB  |  369 lines
  1.          VGACAP v7.1 (c) Copr. 1987-91 Lawrence Gozum & Marvin Gozum
  2.          ───────────────────────────────────────────────────────────
  3.  
  4.                                  User Manual
  5.  
  6.     DISCLAIMER
  7.  
  8.     This product is distributed AS IS.  The authors specifically disclaim
  9.     all warranties ,expressed or implied, including ,but not limited to,
  10.     implied warranties of merchantability and fitness for a particular
  11.     purpose with respect to defects in the diskette and documentation, and
  12.     program license granted herein, in particular, and without limiting
  13.     operation of the program license with respect to any particular
  14.     application use or purpose.  In no event shall the authors be liable
  15.     for any loss of profit or any other commercial damage including but
  16.     not limited to special, incidental, consequential or other damages.
  17.  
  18.  
  19.     LICENSING AGREEMENT
  20.  
  21.     You may use this program for a 10 DAY TRIAL PERIOD.  Should you find
  22.     this program useful, you MUST register it; you will then be provided
  23.     with the latest releases of the VGACAD system see last section of this
  24.     manual).
  25.  
  26.     You can freely distribute copies of unmodified VGACAP and charge $10
  27.     max for distribution, in lieu of recognized Users Group guidelines
  28.     (e.g., Asso. of Shareware Professionals or NY Amateur Computer Club).
  29.  
  30.  
  31.     WHAT IS VGACAP ?
  32.  
  33.     VGACAP is a resident utility that captures pictures in 320x200x256
  34.     VGA/MCGA mode, any 640x480x256 SVGA mode or any 800x600x256 SVGA mode
  35.     (e.g., Genoa GVGA, Tseng 3000/3000, Paradise/PVGA, Trident 8800/8900,
  36.     ATI, Video7, C&T 452/453, Oak, ...) supported.  VGACAP will capture and
  37.     "Bsave" 320x200x256 pictures; SVGA 640x480x256 and 800x600x256 pictures
  38.     will be saved to *.RAW file files (ie., "RAW" pixel dumps).
  39.  
  40.  
  41.     WHAT IS VGAFIL ?
  42.  
  43.     VGAFIL is a conversion program for use in a batch file (*.BAT) or as an
  44.     interactive stand-alone program; RAW and BLD/PLT files are 640x480x256
  45.     or 800x600x256 screens, or 320x200x256 screens respectively.  VGAFIL is
  46.     designed to integrate directly with VGACAD v2.0 (and up) and replace
  47.     BLD2GIF and RAW2GIF.  Moreover, VGAFIL converts and saves captured
  48.     images to 32768-color TGA (Targa 16), 256-color BMP (Windows 3.0), PCX,
  49.     GIF files or 16-color GIF files.  VGAFIL is also a utility to customize
  50.     and configure VGACAP to take advantage of specific SVGA chipset
  51.     hardcoding for FAST screen captures.
  52.  
  53.  
  54.     REQUIREMENTS
  55.  
  56.     About 512KB of memory is required for VGAFIL, although it uses about 2/3
  57.     of that; it, also, requires that the BRUN41.exe runtime module be present
  58.     in your present path; this is explained later in this manual.  You MUST
  59.     have a VGA or MCGA adaptor (at least BIOS compatible) present and an
  60.     analog monitor to use VGACAP.  VGACAP uses about 3KB of RAM.  To use
  61.     the 640x480x256 or 800x600x256 capture mode, you MUST have SVGA.
  62.  
  63.  
  64.     CONFIGURING VGACAP
  65.  
  66.     VGACAP, on default, is set for BIOS operations;  BIOS calls are 'generic'
  67.     and should work with most, if not all, SVGA cards.   However, BIOS calls
  68.     are slow.  By using the hardware configuration, VGACAP will capture
  69.     screens in 2-3 seconds compared to about 20-30 seconds for 800x600x256
  70.     screens (based on 28ms HD on 18 MHz 386sx).
  71.  
  72.     To configure VGACAP for your specific hardware type
  73.  
  74.                         VGAFIL -V <ret>
  75.                                or
  76.                         VGAFIL -C <ret>
  77.  
  78.     A menu will guide you.  Simply select the letter which corresponds to
  79.     your video card chipset.  Remember, when in doubt, return the setting
  80.     to BIOS operations.  BIOS operations does not guarantee that it will
  81.     work, generally, if your video board manufacturer took care in
  82.     writing its BIOS - it SHOULD work.
  83.  
  84.     If you are having compatibility problems with VGACAP or VGAFIL please
  85.     contact Lawrence Gozum by:
  86.  
  87.         1) E-plex at CompuServe [73437,2372]
  88.         2) E-mail at the CompuServe PICs Forum
  89.         3) Telephone (416) 923-3387
  90.         4) Mail at
  91.                         One Oriole Rd. #206
  92.                         Toronto, Ontario
  93.                         Canada M4V 2E7
  94.  
  95.  
  96.  
  97.     HOW TO USE VGACAP
  98.  
  99.     Run VGACAP before entering your painting/CAD or digitized picture
  100.     viewer.   Press <ALT-F4>, while viewing your picture in any paint/CAD
  101.     program and the screen and palette will be saved in your default drive
  102.     and directory.  If you are viewing your picture in MCGA/VGA 320x200x256
  103.     then it will be "Bsaved".  If you are NOT is MCGA/VGA 320x200x256 mode,
  104.     then VGACAP will assume you are in an SVGA mode !
  105.  
  106.                         <alt-F4> is the HOTKEY
  107.  
  108.     The first time you run the program it will save your screen and palette
  109.     to SCREEN00.BLD (.RAW) and SCREEN00.PLT respectively.  If there is an
  110.     existing SCREENxx.BLD (.RAW) or SCREENxx.PLT file, it will increment to
  111.     the next higher number.  You can use your favorite memory managers to
  112.     remove this TSR or reboot to release it from memory.
  113.  
  114.     If you are viewing in 640x480x256 SVGA mode or 800x600x256 SVGA mode,
  115.     then the SCREENxx.BLD file is changed to SCREENxx.RAW; the "Bload" header
  116.     is not included and a "RAW" contiguous pixel dump is implemented.  If you
  117.     wish, you can easily design your own utilities to read and process these
  118.     "RAW" pixel dumps; they are simple contiguous pixel dumps with file sizes
  119.     of 307,200 bytes (i.e., 640 x 480 = 307,200 pixels) for 640x480x256 SVGA
  120.     mode and 480,000 bytes for 800x600x256 SVGA mode.  The *.PLT files remain
  121.     the same.
  122.  
  123.     Note:     When in DOS or using a picture viewer (e.g., PICEM, VPIC, or
  124.               CSHOW) or application which requires a keypress to continue, it
  125.               is necessary to hit another key after hitting the 'HOTKEY'.
  126.  
  127.  
  128.     LOADING/CONVERTING SCREEN GRABS WITH VGAFIL
  129.  
  130.     If you type "VGAFIL <ret>", then you can select any filename by moving a
  131.     highlighted bar (with the arrow keys) and pressing the <return> key.
  132.     Pressing <Spc> allows you to select a different PATH, while <Esc> exits.
  133.  
  134.     A matching *.PLT file MUST exist or an error message will result.
  135.     A *.GIF or *.PCX file is created with the corresponding name.
  136.     GIF/PCX FILES WITH THE SAME NAME WILL BE OVERWRITTEN !
  137.  
  138.     On default, VGAFIL selects RAW/PLT files.  BLD/PLT files can be selected
  139.     by using the "-B" option.
  140.  
  141.                         VGAFIL -B <ret>
  142.  
  143.     On default, all captured screens are converted to GIF (87a) files.
  144.     To convert screens to 256-color PCX files, use the "-P" option.
  145.  
  146.                         VGAFIL -P <ret>
  147.  
  148.     To convert screens to 256-color BMP files for Windows 3.0, use the
  149.     "-W" option (for uncompressed Windows 3.0 "Wallpaper").
  150.  
  151.                         VGAFIL -W <ret>
  152.  
  153.     To convert screens to 32768-color TGA files for XGA, Hercules HGSC,
  154.     Targa cards (and other "high-end clones"), use the "-T" option (for
  155.     uncompressed Targa 16 bits format").
  156.  
  157.                         VGAFIL -T <ret>
  158.  
  159.  
  160.     COMMAND LINE AND BATCH FILES
  161.  
  162.     VGAFIL can be used in batch (*.BAT) files for multiple conversions.
  163.     Simply type "VGAFIL [filename] " with no extension (path optional) for
  164.     every file you want to convert in your batch file;  you can also use
  165.     this method if you want to convert a specific file from DOS.
  166.  
  167.          Examples:   VGAFIL screen00
  168.                      VGAFIL -B screen00
  169.                      VGAFIL \capture\screen99
  170.                      VGAFIL -B \capture\screen99
  171.                      VGAFIL -P \capture\screen99
  172.                      VGAFIL -W \capture\screen99
  173.                      VGAFIL -T \capture\screen99
  174.  
  175.     VGAFIL will automatically search for the RAW/PLT files or BLD/PLT files.
  176.     If no files are found or matching *.PLT file is missing, then an error
  177.     will result; the matching PLT files MUST be in the same drive/directory
  178.     or default drive/directory.
  179.  
  180.  
  181.     TEMP, MVGASCRN, NYBLSCRN, AND USERSCRN FILES
  182.  
  183.     TEMPorary files are used by VGACAD, SQZGIF